Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGSetChannelClip

The SGSetChannelClip function allows you to set a channel's clipping region.

pascal ComponentResult SGSetChannelClip (SGChannel c, 
                                          RgnHandle theClip);

c

Identifies the channel for this operation. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, described on page 5-29 and page 5-30, respectively.

theClip

Contains a handle to the new clipping region. Set this parameter to nil to remove the current clipping region. The channel component makes a copy of this handle; it is your application's responsibility to dispose of this handle when you are finished with it.

DESCRIPTION

The SGSetChannelClip function allows you to apply a clipping region to a channel's display region. By default, channel components do not apply a clipping region to
their displayed image.

SEE ALSO

You may retrieve a channel's clipping region by calling the SGGetChannelClip function, described in the next section.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help